home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / c / tcrat2.com / TCRAT2.DOC < prev    next >
Encoding:
Text File  |  1988-12-23  |  12.9 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.             TC RAT -- TURBO C 2.0 MOUSE DRIVER
  8.             
  9.             I.  I N T R O D U C T I O N:
  10.             
  11.                  TC  Rat  is  a  Microsoft-compatible  mouse  driver  to
  12.             provide mouse  support for  Borland's Turbo C 2.0 Integrated
  13.             Development Environment.  The new Turbo editor is nicer than
  14.             Borland's old ones (such as in Turbo Pascal 3.0).  There are
  15.             now pull-down menus, however, you are still required to know
  16.             the WordStar  commands for  such tasks  as moving  blocks of
  17.             text.  If you can't rattle off the fifty or so WordStar text
  18.             editor commands  off the top of your head, then this program
  19.             is for  you. Now  your Microsoft  mouse (or  compatible) can
  20.             have cursor  support,  context  sensitive  interaction,  and
  21.             added pull-down  menus so  that practically all your choices
  22.             are a  mouse click  away.  This version accommodates the new
  23.             commands available in Turbo C 2.0.
  24.                  This program  is designed  to be  intuitive, so you may
  25.             skip the  directions and  figure out  how the mouse works as
  26.             you go  along.  If you are the more patient type, follow the
  27.             below directions  to get  the most out of this mouse driver.
  28.             Users of  TP Rat for Turbo Pascal 4.0 and 5.0 will find this
  29.             Turbo C  mouse driver  practically the  same  as  the  Turbo
  30.             Pascal counterparts.   In  fact, TC Rat 2.0 is an adaptation
  31.             from TP  Rat 5.0.    As  Borland's  IDE  interface  is  very
  32.             uniform, the  mouse drivers  for Pascal  and  C  share  many
  33.             similar features.
  34.             
  35.             II.  I N S T A L L A T I O N:
  36.             
  37.                  Before you  begin, familiarize  yourself with the below
  38.             files:
  39.             
  40.             FILE                FUNCTION
  41.             
  42.             tcrat2.mnu          Turbo C 2.0 mouse driver (color)
  43.             tcmono2.mnu         Turbo C 2.0 mouse driver (mono)
  44.             tcrat2.doc          This file
  45.             tcrat2.def          Source code for the color driver
  46.             tcmono2.def         Source code for the mono driver
  47.             menu.com            Runtime file necessary to load driver
  48.             
  49.             At this point the installation will depend on your system:
  50.             
  51.                  a) CGA, EGA or VGA systems:  At the DOS prompt type the
  52.             command:
  53.             
  54.             menu tcrat2
  55.             
  56.             This should load the driver.  So that you don't have to type
  57.             this every  time you  run Turbo  C, include  this command in
  58.             your batch  file.   To unload  the driver type "menu off" at
  59.             the DOS prompt.
  60.             
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                  b) Monochromatic  systems:   At the DOS prompt type the
  74.             command:
  75.             
  76.             menu tcmono2
  77.             
  78.             This should  load the  monochromatic version  of the driver.
  79.             So that you don't have to type this every time you run Turbo
  80.             C, include  this command  in your  batch file. To unload the
  81.             driver type "menu off" at the DOS prompt.
  82.             
  83.             III.  D I R E C T I O N S   F O R   U S E:
  84.             
  85.                  The logic  of the  mouse is dependent upon which button
  86.             is pushed -- right, left or both.
  87.             
  88.             LEFT BUTTON:
  89.             
  90.                  Edit mode:   Clicking  this button, while in the normal
  91.             or "Edit"  mode of  the Turbo  editor, will invoke the Turbo
  92.             command line  at the  top of the screen; this is the same as
  93.             if you  had pushed  the F10  key.   Then move  the mouse  to
  94.             select the desired choice.  Now click EITHER mouse button to
  95.             execute this  choice.   Usually this  will pull down another
  96.             menu from  Turbo's editor.   When  in one of these pull down
  97.             menus, again  just move  the mouse to select your choice and
  98.             click EITHER  mouse button.   Again  this may  even take you
  99.             into another pull-down menu.  Again make your selection just
  100.             like before.   You  may get out of any menu by clicking BOTH
  101.             mouse buttons (at the same time).
  102.             
  103.             RIGHT BUTTON:
  104.             
  105.                  Edit mode:   Clicking  this button, while in the normal
  106.             or "Edit"  mode of  the Turbo  editor,  will  invoke  a  new
  107.             command line  across the  top of the screen.  It should have
  108.             the following choices:
  109.             
  110.             Block     Find and Replace         Miscellaneous
  111.             
  112.             Move the  mouse to  position the  cursor over  one of  these
  113.             choices.   Click EITHER  mouse button to invoke your choice.
  114.             If you  get here by mistake, just push BOTH mouse buttons to
  115.             get out of this menu.
  116.                  Each command  will pull  down a  menu of  choices  that
  117.             relates to  the choice  you selected.   Each  is essentially
  118.             self-explanatory, but  refer to  the Turbo  C 2.0  Reference
  119.             Manual (Appendix  A) if  you need further explanation.  Some
  120.             commands require  you to  enter a  number or symbol from the
  121.             keyboard to complete the command.  Again, if you want out of
  122.             any menu just push BOTH mouse buttons to get out.
  123.             
  124.             BOTH BUTTONS:
  125.             
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                  In "Edit"  mode, pressing  both buttons  simultaneously
  140.             will generate  the "Escape" code (27).  This key can be used
  141.             to abort many of the Turbo editors functions.
  142.                  Pressing both  buttons in  any menu  will cause  you to
  143.             exit that menu.
  144.             
  145.             RIGHT or LEFT BUTTON:
  146.             
  147.                  There are  times  when  either  right  or  left  button
  148.             generates the same consequence.
  149.                  During a  "Find" or  "Find and Replace" operation, when
  150.             the "Options"  prompt appears  on screen  line #2,  pressing
  151.             EITHER button  will invoke a "Options" submenu to remind you
  152.             of the possible options available.
  153.                  Also during  a "Find  and Replace"  operation, when you
  154.             are prompted  to respond  "Yes"  or  "No",  pressing  EITHER
  155.             button will invoke a "Yes  No" submenu to allow you to enter
  156.             your response from the mouse.
  157.             
  158.             IV.  N E W   F E A T U R E S
  159.             
  160.                  These changes  are new relative to the TP Rat 4.0 mouse
  161.             driver for  Turbo Pascal  4.0.   There is no earlier version
  162.             for Turbo  C, but  read on  as this  will tell  you  how  to
  163.             execute the start up macro.
  164.                  There are  now two different "autoexec" macros at start
  165.             up.   Pressing the  left button  at start  up will execute a
  166.             "Zoom" and  call up *.c files from the default subdirectory.
  167.             Pressing the  right button  will do  the same except without
  168.             the "Zoom"  function.   Note:  For these macros to work, the
  169.             Borland copyright  message must appear when you first start;
  170.             otherwise, the mouse can't recognize that it is at the start
  171.             of an  editing session.   In  Turbo Pascal  5.0, defining  a
  172.             configuration file  causes  the  copyright  message  to  not
  173.             appear, thus  the mouse  is unable  to execute  the start up
  174.             macro.  This may be the case for the Turbo C editor as well.
  175.                  After a  Bock Move  or Copy  command, the block will be
  176.             unmarked.  This reflects my own preference.
  177.                  New commands  are added  to the Miscellaneous Menu that
  178.             were  not   available  on   previous  drivers.    These  are
  179.             essentially those listed in the Turbo manual.
  180.             
  181.             V.  S U M M A R Y:
  182.             
  183.                  Use  of  this  mouse  is  self-explanatory.    In  sum,
  184.             pressing the  left button  will call  up Turbo's  menu  from
  185.             which you  may enter your choice.  Pressing the right button
  186.             will call  up Turbo  editor commands that previously you had
  187.             to memorize.  Pressing both buttons will exit any menu.
  188.             
  189.             VI.  F O R E S E E A B L E   P R O B L E M S
  190.             
  191.                  There is  a definite  pattern  of  problems  that  I've
  192.             notice from my previous efforts:
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.             
  206.             Q:   I have  a Leading  Edge and  am having trouble with the
  207.             color menus.
  208.             A:   For whatever reason, the Leading Edge (at least earlier
  209.             versions)  had  hardware  compatibility  problems  with  the
  210.             Microsoft mouse  color menus.   I  do not know of a software
  211.             solution to this hardware problem.
  212.             
  213.             Q:   I have a Brand X mouse that's 100% Microsoft compatible
  214.             and I am having trouble with ________ (fill in the blank).
  215.             A:   Solution:   Buy a  Microsoft mouse  or live  with  your
  216.             incompatibility.  I have found from personal experience that
  217.             these other  "compatible" mouses just aren't 100% compatible
  218.             no matter  what their ads say.  If you have such a creature,
  219.             test your  problem on  a friend's Microsoft mouse first.  If
  220.             the problem still exist then, please let me know.
  221.             
  222.             Q:   I used  the "menu  off" command  but I don't regain any
  223.             RAM.
  224.             A:     That's  an   astute  observation.    Why  Microsoft's
  225.             programmers did not design it different is beyond me.  Since
  226.             this mouse  driver is  a TSR,  try one  of the public domain
  227.             "Mark and  Release" programs  if you  need  your  RAM  back.
  228.             Luckily, the driver is a small TSR.
  229.             
  230.             Q:   I have  Clone X computer with a Clone Y extended memory
  231.             board and  I am  running from  a Clone  Z ramdisk  with some
  232.             fancy caching  stuff thrown  in, I  can't get  the mouse  to
  233.             work.
  234.             A:   I am  amazed that  these  type  of  computers  can  run
  235.             anything.  This type of troubleshooting is beyond me.
  236.             
  237.             Q:   I can't  get the mouse driver to work.  I have SideKick
  238.             (or other TSR).
  239.             A:  This mouse driver is a TSR and as such, it is subject to
  240.             all the problems and limitations that goes with that species
  241.             of program.  Fortunately, not too many conflicts exist.
  242.             
  243.             Q:   I've changed  the colors  of the  editor, now the mouse
  244.             does not work any more.
  245.             A:   The mouse  must recognize  when the  IDE menu choice is
  246.             selected (i.e.  when it  changes to attribute 115).  You can
  247.             change the  colors as  long as  the  115  attribute  is  not
  248.             changed.   If you  change this, the mouse will not know when
  249.             the IDE's menu is active and will loose context sensitivity.
  250.             Certainly, there  are some  colors you  can change and still
  251.             have the mouse work.
  252.             
  253.             VII.  D I S C L A I M E R
  254.             
  255.                  This  program   is   intended   solely   for   private,
  256.             noncommercial use.   You are encouraged to copy and share it
  257.             as long  as the  archive file  is always distributed intact.
  258.             While all  reasonable effort  has been  made to  correct any
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.             defects in  this mouse driver, you use it completely AT YOUR
  272.             OWN RISK.   The author expressly refuses any guarantee as to
  273.             the fitness of this product.  You are solely responsible for
  274.             ANY and  ALL damages  that you or others incur in the use or
  275.             misuse of  this program.   If  you have  any reservations to
  276.             this, you are expressly forbidden from using this product.
  277.             
  278.             I welcome  any comments,  suggestions, and  questions  about
  279.             this mouse  driver and  pointing out  errors that invariably
  280.             creep it.   Hey I'm just taking up Turbo C, and I don't have
  281.             a mono  system (and  was guessing about the mono menus).  So
  282.             let me know what I've overlooked.
  283.             
  284.             J. A. Smart    12-22-88   CompuServe EMAIL 73307,2662
  285.             WordStar, Leading  Edge, Borland,  Microsoft, and  so  forth
  286.             retain the  trademarks of  their respective companies.  This
  287.             driver is  not associated  with any trademark, registered or
  288.             otherwise.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.